package com.walkline.weather.inf;

import java.util.Vector;

/**
 * 雅虎Weather RSS Feed XML分析类
 * @author Walkline
 * @version 0.1
 */
public interface Weather extends com.walkline.weather.inf.Object
{
	/**
	 * <b>获取标题</b><br /><br />例子：<code>Yahoo! Weather - Tianjin, CN</code>
	 * @return 标题内容
	 */
	public String getTitle();

	/**
	 * <b>获取链接</b><br /><br />例子：<code>http://us.rd.yahoo.com/dailynews/rss/weather/Tianjin__CN/*http://weather.yahoo.com/forecast/CHXX0133_c.html</code>
	 * @return 链接内容
	 */
	public String getLink();

	/**
	 * <b>获取语言</b><br /><br />例子：<code>en-us</code>
	 * @return 语言种类
	 */
	public String getLanguage();

	/**
	 * <b>获取描述</b><br /><br />例子：<code>Yahoo! Weather for Tianjin, CN</code>
	 * @return 描述内容
	 */
	public String getDescription();

	/**
	 * <b>获取最后生成日期</b><br /><br />例子：<code>Mon, 16 Jun 2014 2:59 pm CST</code>
	 * @return 最后生成日期
	 */
	public String getLastBuildDate();

	/**
	 * <b>获取有效期（分钟）</b><br /><br />例子：<code>60</code>
	 * @return 有效期
	 */
	public String getTTL();

	//yweather:location								//气象预报地区
	/**
	 * <b>获取城市</b><br /><br />例子：<code>Tianjin</code>
	 * @return 城市名
	 */
	public String getLocationCity();

	/**
	 * <b>获取区域</b><br /><br />例子：<code>(Empty)</code>
	 * @return 区域名
	 */
	public String getLocationRegion();

	/**
	 * <b>获取国家</b><br /><br />例子：<code>China</code>
	 * @return 国家名
	 */
	public String getLocationCountry();

	//yweather:units								//气象预报使用的单位
	/**
	 * <b>获取国家</b><br /><br />例子：<code>C</code>
	 * @return 国家名
	 */
	public String getUnitsTemperature();//温度，
	public String getUnitsDistance();//距离，km
	public String getUnitsPressure();//气压，mb（百帕）
	public String getUnitsSpeed();//速度，km/h
	//yweather:wind									//风
	public String getWindChill();//风寒，31
	public String getWindDirection();//风向，190
	public String getWindSpeed();//风速，17.7
	//yweather:atmosphere
	public String getAtmosphereHumidity();		//湿度（百分比），46
	public String getAtmosphereVisibility();	//能见度，4.51
	public String getAtmospherePressure();		//气压，982.05
	public String getAtmosphereRising();		//气压状态（0稳定，1上升，2下降），0
	//yweather:astronomy							//天文信息
	public String getAstronomySunrise();		//日出，4:44 am
	public String getAstronomySunset();		//日落，7:38 pm
	//Image
	public String getImageTitle();				//标题，Yahoo! Weather
	public String getImageLink();				//链接，http://weather.yahoo.com
	public String getImageUrl();				//地址，http://l.yimg.com/a/i/brand/purplelogo//uh/us/news-wea.gif
	public String getImageWidth();				//宽度，142
	public String getImageHeight();			//高度，18
	//Item											//项目元素
	public String getItemTitle();				//预报标题和时间，Conditions for Tianjin, CN at 2:59 pm CST
	public String getItemLink();				//预报链接，http://us.rd.yahoo.com/dailynews/rss/weather/Tianjin__CN/*http://weather.yahoo.com/forecast/CHXX0133_c.html
	public String getItemDescription();		//当前天气概况和明日天气预报，<![CDATA[]]> 
	public String getItemGuid();				//唯一标识，CHXX0133_2014_06_20_7_00_CST
	public boolean getItemGuidIsPermaLink();	//是否永久链接，false
	public String getItemPubDate();			//预报发布时间，Mon, 16 Jun 2014 2:59 pm CST
	public String getItemGeoLat();			//地区纬度，39.13
	public String getItemGeoLong();			//地区经度，117.19
	//yweather:condition							//当前天气预报
	public String getConditionText();			//文字描述，Haze
	public String getConditionCode();			//状态代码，21
	public String getConditionTemp();			//当前温度，31
	public String getConditionDate();			//预报时间，Mon, 16 Jun 2014 2:59 pm CST"
	//yweather:forecast
	public Vector getForecasts();	//未来天气预报
}